home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / pcx2ccs.zip / PCX2CCS.DOC < prev    next >
Text File  |  1995-01-12  |  62KB  |  1,668 lines
  1.  
  2.                 PCX2CCS version 1.0
  3.  
  4.    Minimum requirements: EGA monitor, AT or compatable, 360K free
  5. conventional memory 300K free XMS, EMS or virtual memory
  6.  
  7. DISCLAIMER - AGREEMENT . . . . . . . . . . . . . . . . . . . .3
  8.  
  9. ACKNOWLEDGMENTS. . . . . . . . . . . . . . . . . . . . . . . .4
  10.  
  11. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . .4
  12.  
  13. OVERVIEW . . . . . . . . . . . . . . . . . . . . . . . . . . .5
  14.  
  15. EXECUTION PARAMETERS . . . . . . . . . . . . . . . . . . . . .5
  16.  
  17. SCREEN LAYOUT. . . . . . . . . . . . . . . . . . . . . . . . .6
  18.  
  19. DIRECTORIES. . . . . . . . . . . . . . . . . . . . . . . . . .7
  20.  
  21. MOUSE & KEYBOARD CONTROLS. . . . . . . . . . . . . . . . . . .7
  22.  
  23. EDITING CAPABILITIES . . . . . . . . . . . . . . . . . . . . 11
  24.  
  25. MENUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  26.  
  27. FILE MENU (F1) . . . . . . . . . . . . . . . . . . . . . . . 12
  28.  
  29. EDIT MENU (F2) . . . . . . . . . . . . . . . . . . . . . . . 14
  30.  
  31. VIEW (F3). . . . . . . . . . . . . . . . . . . . . . . . . . 18
  32.  
  33. DO CHART (F4). . . . . . . . . . . . . . . . . . . . . . . . 19
  34.  
  35. INFORMATION MENU (F5). . . . . . . . . . . . . . . . . . . . 20
  36.  
  37. LIBRARY (F6) . . . . . . . . . . . . . . . . . . . . . . . . 20
  38.  
  39. HELP (F7). . . . . . . . . . . . . . . . . . . . . . . . . . 21
  40.  
  41. CURRENT SYMBOL (F8). . . . . . . . . . . . . . . . . . . . . 21
  42.  
  43. PCX VIEWER MODES . . . . . . . . . . . . . . . . . . . . . . 21
  44.      VIEW MODE . . . . . . . . . . . . . . . . . . . . . . . 22
  45.      SELECT SECTION TO PRINT . . . . . . . . . . . . . . . . 22
  46.      SCALE IMAGE . . . . . . . . . . . . . . . . . . . . . . 23
  47.      CHANGE SIZE OF IMAGE. . . . . . . . . . . . . . . . . . 24
  48.      INCORPORATE LIBRARY IMAGE . . . . . . . . . . . . . . . 24
  49.      CUT AND PASTE . . . . . . . . . . . . . . . . . . . . . 25
  50.  
  51. SYMBOL REDUCTION/DITHERING ALGORITHMS. . . . . . . . . . . . 25
  52.  
  53.                               1    
  54.  
  55.  
  56.  
  57.  
  58. A FEW WORDS ABOUT SPEED. . . . . . . . . . . . . . . . . . . 26
  59.  
  60. CONFIGURING/SELECTING A PRINTER. . . . . . . . . . . . . . . 28
  61.  
  62. HOW & WHY TO REGISTER. . . . . . . . . . . . . . . . . . . . 29
  63.  
  64. INTERNATIONAL REGISTRATIONS. . . . . . . . . . . . . . . . . 31
  65.  
  66. REPORTING PROBLEMS/MAKING SUGGESTIONS. . . . . . . . . . . . 31
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.                              2            
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                         DISCLAIMER - AGREEMENT
  108.  
  109. Users of PCX2CCS must accept this disclaimer of warranty:
  110.  
  111.     "PCX2CCS is supplied as is.  The author disclaims all
  112. warranties expressed or implied, including, without limitation,
  113. the warranties of merchantability and of fitness for any purpose.
  114. The author assumes no liability for damages, direct or
  115. consequential, which may result from the use of PCX2CCS".
  116.  
  117.     PCX2CCS is a "shareware program" and is provided at no charge
  118. to the user for evaluation.  Feel free to share it with your
  119. friends, but please do not give it away altered or as part of
  120. another system.  The essence of "user-supported" software is to
  121. provide personal computer users with quality software without
  122. high prices, and yet to provide incentive for programmers to
  123. continue to develop new products.  If you find this program
  124. useful and find that you are using PCX2CCS and continue to use
  125. PCX2CCS after a reasonable trial period, you must make a
  126. registration payment of $40.00 to Chris O'Donnell at the address
  127. below. The $40.00 registration fee will license one copy to YOU
  128. for use on any one computer at any one time.
  129.  
  130.     Anyone distributing PCX2CCS for any kind of remuneration must
  131. first contact Chris O'Donnell at the address below for
  132. authorization. You are encouraged to pass a copy of PCX2CCS along
  133. to your friends for evaluation.  Please encourage them to
  134. register their copy if they find that they can use it.  All
  135. registered users will are entitled to FREE minor upgrades, that
  136. will be mailed to you. Please indicate preferred disk size. I
  137. will notify you when the next version is available. The cost for
  138. mailing a MAJOR upgrade is $5.00, payable BEFORE I mail it.
  139.  
  140.     If you encounter a problem, or have any questions or comments
  141. please contact me.  Anyone who reports a problem will receive a
  142. copy of the non-registered version (if a non-registered user), or
  143. a FREE major upgrade (if a registered user).
  144.  
  145. Chris O'Donnell
  146. PO Box 113
  147. Middlebury, Ct 06762
  148. CIS: 70431,1427
  149. Delphi: CHRISOD
  150. Internet: 70431.1427@compuserve.com
  151.           chrisod@delphi.com
  152.  
  153.  
  154.  
  155.  
  156.                                    3    
  157.  
  158.  
  159.  
  160.  
  161.  
  162.                               ACKNOWLEDGMENTS
  163.  
  164.    To Kathy and Duck for all their help in "breaking" the
  165. program.
  166.    To all the people who volunteered to Beta Test the program and
  167. gave constructive input.
  168.    To Steve Rimmer of Alchemey MindWorks who wrote the graphics
  169. books that became my constant reference on "how-to"           
  170. Especially to my husband & our boys who semi-understand that I
  171. was "working"
  172.  
  173.                               INTRODUCTION
  174.  
  175.      This section will explain WHAT the PCX2CCS program is
  176. intended to do. During the testing of the program, there was a
  177. lot of confusion regarding the display, the output and what
  178. exactly should be expected. In order to ensure that the phrases
  179. and "buzz" words that are used mean the same to everyone, let's
  180. start with some terminology.
  181.  
  182.      PIXEL - a graphical point of resolution. Each graphics
  183. monitor is defined by the number of horizontal and vertical
  184. pixels, EGA is 640x350, VGA is 640x480. When PCX2CCS is started
  185. it sets the pixel resolution, a Super-VGA monitor is normally set
  186. to 640x480, 256 colors. A monitor can be changed to another mode
  187. by specifying that the graphics driver is to use, for example,
  188. the EGA resolution of 640x350. Thus pixel is the individual point
  189. that can be referenced on the monitor.
  190.  
  191.      PCX - A method of encoding and decoding the graphical 
  192. information presented on a monitor. Thus a PCX image is a graphical 
  193. image that has been encoded using this methodology. In order to 
  194. re-generate the display, the decode methodology is used.
  195.  
  196.  
  197.      When an image is originally created, the artist has decided
  198. which colors are to be used and has loaded these colors into a
  199. "palette". The next step is to "draw" the image. Each pixel of
  200. the image has one color assigned to it. The color is indicated by
  201. the palette entry, therefore a pixel whose color is 1, is using
  202. the color located in the first entry of the palette. If the color
  203. located in entry 1 is changed, the pixel will immediately change
  204. to the new color.
  205.  
  206.  
  207.  
  208.  
  209.                               4                            
  210.  
  211.  
  212.  
  213.     When the image is saved, the palette configuration and the
  214. color of each individual pixel is recorded, usually
  215. left-to-right, top-to-bottom.  Thus to restore the image, the
  216. file is read, the palette is loaded and the pixels are colored,
  217. left-to-right, top-to-bottom.
  218.  
  219.                            COLORS AND SYMBOLS
  220.  
  221.     When a PCX file is read into PCX2CCS, each palette entry is
  222. assigned a character. Entry 1 is a '!', entry 2 is a '\' and so
  223. on. There are 256 different characters that can be used (257
  224. including a background symbol). When an image is loaded, the
  225. LIGHTEST color in the palette will be used as the background
  226. against which the grid and all menus are drawn, the DARKEST color
  227. in the palette will be used for the grid lines and all text.
  228.  
  229.     EGA AND 16 COLOR VGA: 16 color monitors are limited to 16
  230. colors out of a possible 64. When an image is loaded, each of the
  231. RGB colors users are converted to the corresponding colors out of
  232. the possible 64 colors. The first 16 unique colors are then used
  233. to draw the image. The original color palette remains intact and
  234. will be used for DMC color assignment and symbol reduction.
  235.  
  236.                                OVERVIEW
  237.  
  238.      The purpose of this program is to take PCX files (some of
  239. which are great pictures) and change them into charted stitch
  240. patterns. The default maximum image size is 640 pixels x 480
  241. pixels. The simplest use is to load in a PCX image and create the
  242. hard copy of the chart.  
  243.  
  244.      Notations used: <alt> or <cntl> indicates to hold down the
  245. alt or cntl key while simultaneously depressing the indicated
  246. key. Thus <alt>R means hold down alt and depress the R key
  247. (upper/lower case is irrelevant) <cntl>page up means hold down
  248. the cntl key and depress the page up key. 
  249.  
  250.                           EXECUTION PARAMETERS
  251.                                     
  252.      Start the program by typing PCX2CCS. There are 2 optional
  253. parameters you can supply:
  254.  
  255.     L/l - set up the mouse as a left-handed mouse, that is swap
  256. the functions of the left and right buttons. If you use this
  257. option, remember to swap the words left and right when reading
  258. the documentation.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.                               5            
  265.  
  266.  
  267.  
  268.     P/p# - Direct the printer output to LPT#. The default is 
  269. LPT1: 
  270.  
  271. Any, all or none of these parameters can be supplied. The order
  272. does NOT matter.
  273.  
  274.                               SCREEN LAYOUT
  275.  
  276.      The screen shows a grid with every tenth line being a dashed
  277. line. Across the top of the screen is an  option bar presenting
  278. the various menus and options. Here is a brief description of the
  279. options, see the section entitled MENUS for complete details of
  280. the menus, see the section entitles PCX VIEWER MODE for details
  281. on View mode.
  282.  
  283.     FILE (F1) - this menu contains options related to file
  284. controls i.e. loading files, saving file, changing directories.  
  285.  
  286.     EDIT (F2) - this menu contains options related to editing the
  287. loaded image.
  288.  
  289.     VIEW (F3) - This menu allows you to either view the image as
  290. in a graphical image viewer, or view the symbols used in the image 
  291. and the currently assigned DMC color number and name.
  292.  
  293.     DO CHART (F4) - This menus allows you to produce a chart of
  294. either the entire image or a section of the image
  295.  
  296.     INFORMATION (F5) - This menu presents you with information
  297. about the current image.
  298.  
  299.     LIBRARY (F6) - This menu allows you to create or edit library
  300. elements, and/or incorporate library elements into the current
  301. image. (SEE LIBRARY FOR MORE INFORMATION)
  302.  
  303.     HELP (F7) - this menu presents you with the various help
  304. topics available.
  305.  
  306.     CURRENT SYMBOL (F8) - this option allows you to change the
  307. current symbol that will be used when adding new symbols
  308.  
  309.     Across the bottom of the screen, and on the right and side
  310. are 2 scroll bars. The marker indicates which section of the
  311. image is currently being seen.
  312.      
  313.     If the entire height or width of the image is visible, then
  314. the corresponding scroll bar will be white, and will NOT respond
  315. to the mouse. 
  316.  
  317.  
  318.  
  319.                          6                                    
  320.  
  321.  
  322.  
  323.     When moving around the image, the edges of the image, and/or
  324. the grid, are indicated by a thick black line.
  325.  
  326.                     DIRECTORIES
  327.  
  328. The program keeps track of 4 independent directories:
  329.  
  330.    1) the current working directory This is the directory used    
  331.       for PCX and CCS file input and output. DEFAULT: directory   
  332.       where PCX2CCS is running.
  333.  
  334.    2) the print directory - This is the directory where charted   
  335.       pcxs are stored. DEFAULT: \CCSPRT under the directory where 
  336.       PCX2CCS is running, it will be created.
  337.  
  338.    3) the library directory - This is the directory used for      
  339.       library element input and output. DEFAULT: \LIB under the   
  340.       directory where PCX2CCS is running, it will be created.
  341.  
  342.    4) The directory where PCX2CCS is running from - This is the   
  343.       place were the printer and machine configuration files are  
  344.       expected to be found.
  345.  
  346.     The first 3 directories can be changed via the file selection
  347. window.  If you change any directory, it will be "remembered"
  348. until it is changed again. In addition, you can change the
  349. defaults by using the configuration option on the FILE MENU and
  350. specify the default directories and DMC file to be used.
  351.  
  352.     The default file for RGB-DMC color mapping is MASTER.DMC,
  353. located in the same directory where PCX2CCS is located. This
  354. default can also be changed via the configuration menu. In
  355. addition, you can change the dmc file using the SELECT DMC DATA
  356. FILE on the FILE MENU. 
  357.  
  358.               MOUSE & KEYBOARD CONTROLS
  359.                           
  360.     Personally I can't stand the mouse and I object to any
  361. software that requires the mouse. Therefore, everything that can
  362. be done via the mouse can be done via the keyboard. The menu
  363. options can be invoked via an <alt> key combination. The key
  364. combination is indicated on the menu by a diamond followed
  365. by the key. This information is also available vie the help menu
  366. option "Keystrokes". 
  367.  
  368.     The menus themselves can be invoked by the corresponding
  369. Function key, F1 is FILE, F2 is edit and so on. 
  370.  
  371.  
  372.  
  373.  
  374.                               7                    
  375.  
  376.  
  377.  
  378.     All up and down scroll bars can be activated as follows:
  379.  
  380.     1) position the arrow on the marker,  depress the left mouse
  381. button and move the marker up and down.
  382.  
  383.     2) position the arrow on the up or down arrow and depress the
  384. left button    
  385.  
  386.     3) position the arrow in the black section above or below the
  387. marker and depress the left mouse button.
  388.  
  389.     As long as the mouse button is depressed, the marker will
  390. move. The arrows increment/decrement the marker by 1, the
  391. black section of the scroll bar moves the marker by 1 "page". A
  392. menu "page" is the next section of menu option, a grid "page" is
  393. the next section of the grid. Page Up and Page Down will also
  394. perform a "page" scroll.  The menu, file list or grid will NOT be 
  395. updated until the mouse button is released and the marker stops
  396. moving.
  397.  
  398.     The left and right scroll bars responds in an identical
  399. manner. The key combination to move the marker is <cntl>L to
  400. scroll 1 page left and <cntl>R to scroll 1 page right. 
  401.  
  402.    In addition the scroll bars for the grid will also respond to
  403. <cntl>Page Up to scroll to the top of the image, <cntl>Page Down
  404. to scroll to the bottom, <cntl>End to scroll to the far right of
  405. the image and <cntl>Home to scroll to the far left.
  406.  
  407.     The arrow itself will also respond to the keyboard. The arrow
  408. keys will move the arrow 1 space. The Home key will position the
  409. arrow at the furthest most left square and End will position the
  410. arrow the furthest most right square.
  411.  
  412.     All of the windows use the same format to present
  413. information. The CANCEL button or ESC key will terminate windows
  414. without performing any action. The OK button or ENTER will
  415. perform the selected action. To select from a list, position the
  416. arrow on the desired option and depress the left button. A
  417. highlight bar will appear indicating the selected option. Keeping
  418. the button depressed and moving the mouse will move the highlight
  419. bar up and down. Release the mouse button  and select OK to
  420. finish making a selection. To view more of a list, use the scroll
  421. bar.
  422.  
  423.     To make a selection via the keyboard, depress the S key to
  424. activate the highlight bar. Use the up and down arrow keys to
  425. move the highlight bar up and  down. When the desired option is
  426.  
  427.  
  428.  
  429.                          8                                            
  430.  
  431.  
  432.  
  433. highlighted, hit ENTER. Use Page Up and Page Down to active the
  434. scroll bars.
  435.  
  436.     If you have highlighted an option and then scroll, the
  437. highlight bar will go away and you will have to re-select and
  438. option. 
  439.  
  440.     To select a checkbox, such as a dithering algorithm, the
  441. keystroke is presented in parenthesis. Depressing the indicated
  442. key will 'X' the associated box, indicating that the option is
  443. selected. To use the mouse, position the arrow on the check box
  444. and depress the left button. To de-select a checkbox, select the
  445. box again. Some check boxes are exclusive, so that selecting
  446. another option may de-select the selected option.
  447.  
  448.     Editable text is presented in a box filled with the
  449. information to be edited. Select the box either by positioning
  450. the arrow on the box, of by depressing the associated key. A
  451. cursor marker will appear at the beginning of the text. The
  452. cursor can be moved left and right via the arrow keys. The DEL
  453. key will delete characters to the right of the cursor, the
  454. backspace arrow will delete the character to the left of the
  455. cursor. Additional characters can be inserted at the cursor
  456. marker. The maximum number of characters is limited by the length
  457. of the box.
  458.  
  459.     The window for selecting files for loading or saving files
  460. presents the current directory path and file extension used, a
  461. scrollable list of the files found in the directory, and an
  462. editable field. When loading a file, the editable field is blank.
  463. When a file is selected the editable field displays the file
  464. name. Selecting OK will load the selected file. When saving a
  465. file, the name of the previously loaded file, with the
  466. appropriate extension is presented in the editable field. To save
  467. using this file name, select OK. To save to a different file, 
  468. select desired file and select OK. To save to new and different
  469. file name, edit the name in the editable field and select OK.
  470.  
  471.     To change the directory, select ..\ to go up 1 level or
  472. select the directory name in the file list, to go down 1 level.
  473. The file list will be update to reflect the files in the new
  474. directory. The new directory will be saved and used for
  475. subsequent file selections.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.                               9                            
  484.  
  485.  
  486.  
  487.  
  488.  
  489.                          KEY STROKES & HOT KEYS
  490.           
  491.      Right arrow/R/r - move mouse arrow 1 square to the right *
  492.      
  493.      Left arrow//L/r - move mouse arrow 1 square to the left *
  494.      
  495.      Up arrow/U/u - move mouse arrow 1 square up *
  496.      
  497.      Down arrow/D/d - move 1 mouse arrow square down *
  498.      
  499.      home/H/h - move mouse arrow to farthest left visible square
  500.      
  501.      end/E/e - move mouse arrow to the farthest right visible     
  502.                square
  503.      
  504.      page up - scroll up 1 screen height of the grid
  505.      
  506.      page down  - scroll down 1 screen height of the grid
  507.      
  508.      <cntl>R - scroll to the right 1 screen width of the grid  
  509.      
  510.      <cntl>L - scroll to the left 1 screen width of the grid
  511.      
  512.      <Cntl>Home - move to the left edge of the design *
  513.      
  514.      <Cntl>End - move to the right edge of the design *
  515.      
  516.      <Cntl>Page up - Move to the top of the design *
  517.      
  518.      <Cntl>Page down - Move to the bottom of the design *
  519.      
  520.      C/c - move to the center of the grid no matter where in the
  521.            grid you are
  522.  
  523.      F1 - File Menu
  524.      F2 - Edit Menu
  525.      F3 - View Menu
  526.      F4 - Do Chart Menu
  527.      F5 - Information Window
  528.      F6 - Library Menu
  529.      F7 - Help Menu
  530.      F8 - Change Current Symbol
  531.      <alt>A - Save Image as a PCX
  532.      <alt>B - Toggle Background Stitch on/off
  533.      <alt>C - Cut & Paste Edit
  534.      <alt>D - Use a different DMC data file
  535.  
  536.  
  537.  
  538.                                    10        
  539.  
  540.  
  541.  
  542.  
  543.  
  544.      <alt>E - Select a section to print
  545.      <alt>F - Change configuration
  546.      <alt>I - Show Information about a PCX file
  547.      <alt>J - Show Information about an CCS file
  548.         <alt>L - Load a PCX
  549.      <alt>M - Mass symbol update
  550.      <alt>N - Reduce number of symbols
  551.      <alt>P - Change Color Palette
  552.      <alt>Q - Quit without Saving
  553.      <alt>R - Restore current image
  554.      <alt>S - Scale current image
  555.      <alt>T - Toggle between B&W symbols and colored symbols
  556.      <alt>V - View current image as a graphical image Viewer
  557.      <alt>W - Print entire chart
  558.      <alt>X - Load CCS file
  559.      <alt>Z - Save CCS file
  560.      <alt>1 - View symbols and DMC color number and name
  561.      <alt>2 - Edit Rows and/or Columns
  562.      <alt>3 - Change current symbol color
  563.      <alt>6 - Load library element for editing
  564.      <alt>7 - Save library element
  565.      <alt>8 - Incorporate library element into image
  566.      
  567.     * These commands will also control the box in graphical image viewer mode
  568.      
  569.  
  570.                     EDITING CAPABILITIES
  571.               
  572.     There are 3 ways to edit the image. One method is a
  573. symbol-by-symbol method, another is to use the cut & paste option
  574. on the edit menu (SEE GRAPHICAL IMAGE VIEWER MODE FOR DETAILS), and 
  575. finally the MASS UPDATE option on the EDIT menu (<ALT>M) can be used to
  576. change ALL OCCURRENCES of specified symbols.
  577.  
  578.      Symbols can be added to the pattern and deleted from the
  579. pattern using the ENTER key and DEL key, or the left and  right
  580. mouse buttons, respectively.  These keys will perform their
  581. actions on the grid square where the cursor is.  Symbols can be
  582. replaced by positioning the arrow on the symbol to be replaced,
  583. and hitting enter or the left mouse button. The Current Symbol
  584. will replace the previous symbol. With the mouse you can do
  585. repeated adds/deletes by continuing to hold down the mouse button
  586. as you move it. Any square the arrow passes over will have the
  587. symbol added or deleted. 
  588.  
  589.      In addition to editing 1 symbol at a time technique, the
  590.  
  591.  
  592.  
  593.                               11                                
  594.  
  595.  
  596.  
  597.  
  598. borders of the image can be adjusted. Using the Edit Menu, it is
  599. possible add rows or columns to the edges of the design. The
  600. border markers will be moved out 1 row/column. It is also
  601. possible to move the border IN to the current cursor position.
  602. When the borders are moved in, all symbols the are beyond the new
  603. border(s) are deleted. This technique can be used to trim or crop
  604. an image by positioning the cursor at the edges of the desired
  605. section, and moving the borders in.                               
  606.  
  607.  
  608.                         MENUS
  609.     
  610.     The menus are listed across the top of the screen. The hot
  611. keys for the menus is the corresponding function key. NOTE: IF
  612. YOU HAVE RE-DEFINED YOUR FUNCTION KEYS THEN THEY WILL NOT BE HOT
  613. KEYS.
  614.     
  615.      Every menu functions in the same manner, the options for the
  616. menu are presented in a scrollable list. The list can be scrolled
  617. either by the mouse or the keyboard. To select an option using
  618. the mouse, position the mouse arrow on the desired option and hit
  619. the left mouse button. Keeping the button depressed and moving
  620. the mouse will move the highlight box up and down. Moving the
  621. arrow off the menu list will shut off the highlight bar.
  622. Releasing the mouse button will leave the highlight bar on the
  623. selected option. After highlighting the desired option, click
  624. the OK button. Selecting CANCEL will terminate the menu with no
  625. action taken.  To select an option via the keyboard, depress
  626. the 'S' key and the highlight bar will appear. Using the up and
  627. down arrows, position the highlight bar on the desired option.
  628. Hit ENTER to activate the selected option, hit ESC to cancel.
  629.  
  630.                     FILE MENU (F1)
  631.  
  632.     The file menu has all the options for file input and output.
  633. From here you can select the image to load, where to save the
  634. current image, get information about an image, change the DMC
  635. file to use, change the configuration of the machine, either
  636. permanently or temporarily and exit from the program. The 10
  637. options are:
  638.  
  639. LOAD PCX FILE - This option will display a list of PCX files in
  640. the current directory. Select the PCX file to load, or change
  641. directories.OK/ENTER will load the selected file, CANCEL/ESC will
  642. NOT load.
  643.  
  644. LOAD CCS FILE - This option will display a list of CCS files
  645. in the current directory. Select the CCS file to load, or change
  646.  
  647.  
  648.  
  649.                               12                                    
  650.  
  651.  
  652.  
  653.  
  654. directories. OK/ENTER will load the selected file, CANCEL/ESC
  655. will NOT load.
  656.           
  657. INFORMATION ABOUT PCX - This option will display a list of PCX
  658. files in the current directory. Select the PCX file for
  659. information, or change directories. If you select a file, the
  660. height and width will be display. At this point you can select to
  661. Load (ENTER) or Not Load (CANCEL) the PCX.
  662.  
  663. INFORMATION ABOUT CCS - This option will display a list of CCS
  664. files in the current directory. Select the CCS file for
  665. information, or change directories. If you select a file, the
  666. height and width will be display. At this point you can select to
  667. Load (ENTER) or No Load (CANCEL) the CCS.
  668.  
  669. SAVE CURRENT PATTERN (CCS) - This option will display a list of
  670. CCS files in the current directory. Select the CCS file to be
  671. written to, or enter a new file name. OK/ENTER will write to the
  672. file the symbols colors, the DMC information and the current
  673. image.  Although the image information is in standard PCX
  674. format, the rest of the information is unique to this program,
  675. and thus this file can ONLY be read by this program.
  676.  
  677. SAVE AS PCX FILE - This option will display a list of PCX files
  678. in the  current directory. Select the PCX file to be written to,
  679. or enter a new file name. OK/ENTER will create a standard PCX
  680. file that can be read by any PCX viewer.
  681.  
  682. QUIT (NO SAVE) - The program willl gracefully exit,without saving
  683. the current image.  
  684.      
  685. SAVE (CCS) & EXIT - This option is a combination of SAVE CURRENT
  686. PATTERN and QUIT.
  687.      
  688. SELECT DMC DATA FILE - This option will present a list of .DMC
  689. file in the current working directory. Select the file to use for
  690. subsequent images. The file will be read immediately and the DMC
  691. information will be assigned to the current image.
  692.  
  693. CHANGE CONFIGURATION - This option allows you to change the
  694. graphics resolution of the monitor, the maximum image height and
  695. width, the spacing for the dashed lines and the default startup
  696. directories and files. The maximum height multiplied by the
  697. maximum width cannot exceed the largest amount of free memory.
  698. This information can be saved and will then be the default
  699. configuration, or it can set for just the current session. 
  700.  
  701.  
  702.  
  703.  
  704.                               13
  705.                                                                                                                                                                         
  706.  
  707.  
  708. WARNING: IF YOU SET THE GRAPHICS SCREEN RESOLUTION FOR GREATER
  709. THAN YOUR MONITOR/VIDEO CARD CAN HANDLE YOU WILL DAMAGE YOUR
  710. MONITOR/CARD. IT IS YOUR RESPONSIBILITY TO KNOW THE MAXIMUM
  711. RESOLUTION. I AM NOT RESPONSIBLE FOR DAMAGE CAUSED BY SETTING THE
  712. RESOLUTION TOO HIGH. 
  713.  
  714.                     EDIT MENU (F2)
  715.  
  716.     The edit menu contains 10 options for changing both the image
  717. and the presentation of the image. 
  718.  
  719. MASS SYMBOL UPDATE - This option performs deletion, addition and
  720. replacement of all occurrences of specified symbols. When this
  721. option is selected a second window presents the options for Mass
  722. Update. These options are:
  723.      
  724. 1) RE-INITIALIZE GRID - Clear the grid of all symbols and reset
  725. the size of the grid to the maximum height and width, and reset
  726. the color palette.
  727.      
  728. 2) DELETE 1 SYMBOL - A window displaying all the symbols is
  729. presented with a "select symbol to delete" message across the 
  730. top. Select the desired symbol by selecting the associated
  731. checkbox. The arrow starts at the current symbol. The arrow will
  732. move according to the mouse or via the arrow keys. When the
  733. desired symbol is selected, select OK (Enter).  To abort this
  734. function select CANCEL.
  735.      
  736. 3) REPLACE 1 SYMBOL WITH ANOTHER - A window displaying all the
  737. symbols is presented with a "Replace This symbol...." message
  738. across the top. Select the desired symbol by selecting the
  739. associated checkbox. The arrow starts at the current symbol. The
  740. arrow will move according to the mouse or via the arrow keys. To
  741. abort this function select CANCEL.  When the desired symbol is
  742. selected, select OK (Enter). The message has "...With This
  743. Symbol" appended to it.  Select the symbol to be used for
  744. replacement. Select OK to perform the replacement, select CANCEL
  745. to abort process.
  746.      
  747. 4) FILL BLANK SQUARES WITH A SYMBOL - A window displaying all the
  748. symbols is presented with a "Select symbol to fill in blanks"
  749. message across the top. Select the desired symbols by selecting
  750. the associated checkbox. The arrow starts at the current symbols. 
  751. The arrow will move according to the mouse or via the arrow keys.
  752. When the desired symbol is selected, select OK (Enter). To abort
  753. this function select CANCEL.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.                          14    
  760.  
  761.  
  762.  
  763. SCALE - This option allows the image to be scaled up or down, in
  764. or out. In the lower left corner of the window is the current
  765. size in stitches and inches. As scale options are selected and
  766. changed, this information is updated. The scale options are:
  767.      
  768. 1) SCALE HEIGHT UP (U) - Select this option to increase the
  769. HEIGHT of the image. A second line will appear: (R) Expand 1 row
  770. into X, where X is an editable field.
  771.      
  772. 2) SCALE HEIGHT DOWN (D) - Select this option to decrease the
  773. HEIGHT of the image. A second line will appear: (R) Combine X
  774. rows into 1, where X is an editable field.
  775.      
  776. 3) SCALE WIDTH OUT (O) - Select this option to increase the WIDTH
  777. of the image. A second line will appear: (C) Expand 1 row into X,
  778. where X is an editable field.
  779.      
  780. 4) SCALE WIDTH IN (I) - Select this option to decrease the WIDTH
  781. of the image. A second line will appear: (C) Combine X rows into
  782. 1, where X is an editable field.
  783.      
  784. After setting the scale options, select OK, or hit the Enter key.
  785. You will be put into PCX viewer mode, showing the image as it
  786. looks with the scale factors applied. From here you can save the
  787. image, or not. (See PCX VIEWER MODES for more information about
  788. the various PCX viewer modes)
  789.  
  790. CUT & PASTE - This option will put you into PCX viewer mode. In
  791. this mode the box can be used to encompass the section of the
  792. image to the moved, copied or deleted. See PCX VIEWER MODES for
  793. the various options.
  794.  
  795. EDIT ROWS/COLUMNS - The option allows you to add or insert blanks
  796. rows and/or colunms, or delete or clip rows and/or columns from
  797. the image. A window presents 2 groups of options, the ACTION to
  798. be performed and the DIRECTION of the action. The actions are:
  799.      
  800. Add (A) - Add to the EDGE of the image
  801. Insert (I) - Insert within the image
  802. Delete (D) - Delete within the image
  803. Clip (C) - Delete everything to the edge and move the edge to a
  804. new position. 
  805.      
  806. Any 1 of these options can be selected. The next 4 options
  807. control the DIRECTION of the action:
  808.      
  809. Left (L)
  810.  
  811.  
  812.  
  813.  
  814.                               15
  815.  
  816.  
  817.  
  818.  
  819. Right (R)
  820. Top (T)
  821. Bottom (B)
  822.      
  823. Any and all of these directions can be selected at the same time.
  824.  
  825. Finally, for Add, Insert and Delete you can change the NUMBER of
  826. rows and/or columns to Add, Insert or Delete:
  827.  
  828. This Many (#): The default is 1, but this can be changed.
  829.  
  830. If you selected Insert or Delete you will be prompted to position
  831. the mouse at the row or column where you wish the insertion or
  832. deletion to begin. You will receive this message once for every
  833. direction you choose, thus if you selected to insert 1 row/column
  834. in all 4 directions you will be prompted 4 times to specify a
  835. location. The prompt will contain information about the
  836. direction. 
  837.  
  838. CHANGE SYMBOL COLOR - This option will present the entire color
  839. palette from which  you can select the color to be used by the
  840. current symbol. There may be 2 "pages" of colors. Select Next or
  841. Prev to switch between pages. The arrow will respond to both the
  842. mouse movement, and the arrow keys.
  843.  
  844. CHANGE COLOR PALETTE - This option will also present the entire
  845. color palette. When you have selected the color you wish to 
  846. change, a window will display a large colored square and 3 scroll
  847. bars. At the top of each scroll bar is a number. As indicate by
  848. the label at the bottom of each scroll bar, each bar represents
  849. the red, green and blue components of the selected color.
  850. Changing the amount of red, green and/or blue will change the
  851. color. You can change the red, green or blue by either sliding
  852. the scroll thumb up or down, or by selecting the number at the 
  853. top of the bar, and typing in a new value. The valid value range
  854. is 0 to 255. Using the keyboard, R will active the red bar, G the
  855. green and B the blue. The thumb will respond to the page up and
  856. page down keys. Once the new color is ready, select OK/enter and
  857. the new color will replace the old.
  858.  
  859. TOGGLE COLOR/B&W SYMBOLS - This option will toggle between
  860. displaying colored symbols in the grid and displaying "black"
  861. symbols in the grid. 
  862.  
  863. TOGGLE BACKGROUND SYMBOLS - This option will change every blank
  864. square to a "background symbol", using the background colored
  865. defined for the image.
  866.  
  867.  
  868.  
  869.                               16    
  870.  
  871.  
  872.  
  873. REDUCE NUMBER OF SYMBOLS - This option will let you reduce the
  874. total number of symbols used in the image. The process of
  875. reducing the number of symbols involves creating a new color
  876. palette and then remapping (with or without dithering) the old
  877. image to a new image. Since this involves reading every single
  878. symbols twice, the bigger the image, the longer it takes.
  879. Messages identifying the various steps are displayed.  
  880.  
  881. The window pre sents 2 categories of options: How many symbols to
  882. reduce to and What algorithm to use (if any) after creating the
  883. new color palette.  You can reduce the number of symbols to:
  884.      
  885. No More Than 8 Symbols (1)
  886. No More Than 16 Symbols (2)
  887. No More Than 32 Symbols (3)
  888. No More Than 64 Symbols (4)
  889. No More Than 128 Symbols (5)
  890.      
  891. The phrase "No More Than" is used because depending on the
  892. initial color palette,  you may not get EXACTLY 8 symbols, it
  893. might be 7 or even 5.
  894.  
  895.     There are 7 different algorithms that can be selected for
  896. adjusting the image to the new palette. These options are:
  897.       
  898. Floyd Dither Algorithm (F)
  899. Stucki Dither Algorithm (S)
  900. Burkes Dither Algorithm (B)
  901. ReMap - No Dither (R)
  902. Magic Square Matrix (M)
  903. Dispersed Dot Matrix (D)
  904. Clustered Dot Matrix (C)
  905.     
  906. When an image has the number of colors reduced, a brand new
  907. palette is created. This new palette is created by determining
  908. the most commonly used colors and the most unique colors in the
  909. exiting palette. After creating the NEW palette, every single
  910. symbol is then examined to determine which color in the NEW
  911. palette is the BEST substitute for the color in the OLD palette. 
  912. This is a simple re-map, without any dithering. Most of the time,
  913. the resulting image is so-so. In an attempt to make a "better"
  914. image there are 6 different dithering algorithms. The first 3
  915. options are different mathematical filters. 
  916.  
  917.      As the new color for each occurrence of each symbol is
  918. determined, an "error" is computed. This error indicated how far
  919. "off" the new RGB is from the old RGB. This error is than
  920.  
  921.  
  922.  
  923.  
  924.                               17        
  925.  
  926.  
  927.  
  928. distributed, adding or subtracting a number to the R, G and B
  929. values of the surrounding pixels. Each filter uses a different
  930. calculation for this distribution.  For more details about the
  931. math involved in each algorithm, see the section entitled
  932. DITHERING ALGORITHMS.
  933.  
  934. There are also 3 Matrix filters. These 3 matrixes provide a
  935. pattern for dithering. The Magic Square matrix is a pretty good
  936. matrix. The Dispersed Dot matrix uses a crosshatched pattern
  937. while Clustered-Dot uses a pattern similar to the pattern used by
  938. newspapers. All 3 were provided by the graphics library I use,
  939. and as such I don't have any way to provide any feedback while
  940. it's working. 
  941.  
  942. RESTORE IMAGE - This option will restore the original image by
  943. re-decoding the PCX or CCS file. 
  944.  
  945.                     VIEW (F3)
  946.    
  947.     There are 2 options on the view menu: View image and View
  948. symbols.Selecting View image will put you in PCX viewer mode.
  949. (See PCX VIEWER MODES for details of the various functions that
  950. can be performed.) The image will be drawn without the grid
  951. lines, but with a box showing the section of the image that was
  952. visible in grid mode. The box can be moved and new location
  953. selected.
  954.  
  955.     View Symbols will present you with a scrollable list of all
  956. the symbols currently used in the image, and the DMC color number
  957. and color name assigned to the symbol. This color number and name
  958. can be changed by selecting a symbol. The DMC information will
  959. appear in 2 appropriately labeled files. You can selected either
  960. field and change, edit or erase the information. 
  961.  
  962.     You can also get a copy of just the symbol table by selecting
  963. PRINT. This copy can either be printed or put to a PCX file. If
  964. you choose to create a PCX file of the symbol table, you will be
  965. presented a window showing the files in the current print
  966. directory.  You can change the directory, select a file, or enter
  967. a name for a new file. The symbol table will then be encoded
  968. to the file. 
  969.  
  970.     If you choose to print to the printer you will be presented
  971. the following information:      
  972. Page Height (H):
  973. Page Width (W):
  974. Title etc (T):
  975.      
  976.  
  977.  
  978.  
  979.                          18        
  980.  
  981.  
  982.  
  983.     Changing the Page height and/or width will change how much of
  984. the symbol table can be printed in each page. Using the Title
  985. field, you can add up to 50 characters for a title, copyright or
  986. other information. Select OK when the information is correct.
  987.  
  988.                          DO CHART (F4)
  989.  
  990.     This option allows you to create a chart of the current
  991. image. You can select to create the full chart, or create a chart
  992. of a section of the image. If you choose to select a section of
  993. the image to chart,  you will be put into pcx viewer mode to
  994. select the section.  If there is no pcxccspt.cfg file present, a
  995. PCX file is the default, otherwise the printer is the default. To
  996. create a pcxccspt.cfg file see the section entitled
  997. "CONFIGURING/SELECTING A PRINTER" 
  998.  
  999.     In either case, when you are ready to create the chart you
  1000. have 2 options:  Print the chart on the printer or create a PCX
  1001. file of the chart.  If you choose to create a PCX file of the
  1002. chart, you will be presented a window showing the files in the
  1003. current print directory. You can change the directory, select a
  1004. file, or enter a name for a new file. The image will then be
  1005. charted to the file.
  1006.  
  1007.     If you choose to print to the printer you will be presented
  1008. the following information:
  1009.      
  1010. Page Height (H):
  1011. Page Width (W):
  1012. Title etc (T):
  1013.      
  1014.     Changing the Page height and or width will change how much of
  1015. the chart can be printed in each page. Using the Title field, you
  1016. can add up to 50 characters for a title, copyright or other
  1017. information.
  1018.  
  1019.     At this point you wil also have to select the Dots Per Inch
  1020. (DPI) that you want the printer to use. The avaialble DPI options
  1021. are presented as checkboxs. Select the density you want to use.
  1022. The higher the DPI, the smaller the squares. Select OK when the
  1023. information is correct. 
  1024.  
  1025.     In addition to any title, on the top of each page will ba a
  1026. page number, for example page 1.1, page 1.2, page 2.1 The first
  1027. number is the "column" the second number is the row. This
  1028. information is presented to help with multi-paged charts.
  1029.  
  1030.  
  1031.  
  1032.  
  1033.                          19        
  1034.  
  1035.  
  1036.  
  1037.  
  1038.     If the chart of the image plus the symbol table take up more
  1039. than 1 page, the symbol table will be printed on a separate page.
  1040.  
  1041.                     INFORMATION MENU (F5)
  1042.  
  1043.     The information menu presents the information for the current
  1044. image, including the size in stitches and inches and the current
  1045. evenweave count. Any and all of these bits of information can be
  1046. changed and the associated information will reflect the change.
  1047. But NO physical change is made to the image until OK is selected.
  1048.  
  1049.     To change any field, select the box where the information is,
  1050. or depress the associated key. A cursor marker will appear at the
  1051. far left of the box. As long as the cursor marker is visible the
  1052. field can be edited. The marker moves via the left and right
  1053. arrows, the home and end keys, and the backup and delete key.
  1054. After makeing your changes, select  OK or hit enter. If you
  1055. changed the Image height and/or width, in stitches or inches, you
  1056. will be put into the PCX Viewer Mode to view the resulting image.
  1057. (See PCX VIEWER MODE for information about the various modes and
  1058. menus). If  you changed the EvenWeave count you will return to
  1059. the grid, with no visible changes. 
  1060.  
  1061.                     LIBRARY (F6)
  1062.  
  1063.     The library function allows you to incorporate other PCX
  1064. images into the current image. A library element is defined as
  1065. any PCX file located in the directory defined as the library.
  1066. There are 3 options on the menu: 
  1067.  
  1068. EDIT LIBRARY ELEMENT - This option allows you to load a PCX image
  1069. from the library directory and edit it. The library directory can
  1070. be changed to any directory. The default directory is /LIB under
  1071. the directory where PCX2CCS is running from. 
  1072.  
  1073. SAVE LIBRARY ELEMENT - This option allows you to save the current
  1074. image into the library directory for later incorporation.
  1075.  
  1076. INCORPORATE LIBRARY ELEMENT - This option allows you to select an
  1077. image from the current library directory to incorporate into the
  1078. current image. After selecting the element, you will be switched
  1079. into PCX Viewer mode. This box indicates the relative of the
  1080. selected library element. The box can be moved around, the size
  1081. changed until it is positioned where you want the element.
  1082. Hitting the left mouse button/Enter will incorporate the element
  1083. into the image. See PCX VIEW MODE for other details of the pcx
  1084. viewer mode. 
  1085.  
  1086.  
  1087.  
  1088.                          20
  1089.  
  1090.  
  1091.  
  1092.  
  1093.                          HELP (F7)
  1094.    
  1095.     This menu contains extracts from this document. The menu
  1096. options are:
  1097.      
  1098. SCREEN LAYOUT
  1099. MENUS
  1100. FILE
  1101. EDIT
  1102. SYMBOL
  1103. VIEW
  1104. VIEW IMAGE
  1105. VIEW SYMBOLS
  1106. PRINTING CHART
  1107. INFORMATION/RESIZE
  1108. SCALE
  1109. KEYSTROKES
  1110. LIBRARY FUNCTION
  1111. PCX VIEW MODES
  1112. DMC COLORS
  1113. COLOR/SYMBOL REDUCTION
  1114.     
  1115.                     CURRENT SYMBOL (F8)
  1116.  
  1117.     The current symbol is the symbol that will be added to the
  1118. image. To select another symbol, select the CURRENT SYMBOL or
  1119. depress F8. This will present a window of all the symbols.  The
  1120. current symbol has an 'X' in the associated checkbox. To select a
  1121. new symbol to be used as the current symbol, move the 'X' to a
  1122. new symbol. OK will save this symbol as the current, CANCEL will
  1123. terminate this function.
  1124.  
  1125.                          PCX VIEWER MODES
  1126.  
  1127.     There are 6 functions that use a PCX viewer mode. Each of
  1128. these functions has it's own menu. Whenever you start a PCX
  1129. viewer function, or change a pcx viewer function, a message will
  1130. remind you that to get the menu for the function, hit Enter/left
  1131. mouse button.  Each menu has 8 identical options:
  1132.  
  1133. RETURN TO GRID - This option will return you to grid mode showing
  1134. the same section of the image that was visible  before entering
  1135. the pcx viewer mode.
  1136.  
  1137. PRINT ENTIRE IMAGE - This option will chart the entire image as
  1138. you currently see it. As with the chart option on grid mode, you
  1139. will be able to create either a PCX of the chart or a hard copy
  1140. of the chart. If you have changed the size of the image, either
  1141.  
  1142.  
  1143.  
  1144.                               21
  1145.  
  1146.  
  1147.  
  1148. by scaling or re-sizing, the chart be printed exactly as you are
  1149. viewing it.
  1150.  
  1151. SCROLL IMAGE - If the dimensions of the image are greater than
  1152. the screen resolution, you can scroll the image. Two scroll bars
  1153. will appear, one down the right side of the image, and one across
  1154. the bottom. Using the scroll bars you can change the section of
  1155. the image that you are viewing.
  1156.  
  1157. CHANGE TO  SIZE FUNCTION 
  1158. CHANGE TO SCALE FUNCTION
  1159. CHANGE TO PRINT FUNCTION
  1160. CHANGE TO LIBRARY FUNCTION
  1161. CHANGE TO EDIT FUNCTION
  1162. CHANGE TO VIEW FUNCTION - Each of these options will change the
  1163. menu you get when you hit enter. You will reminded to hit enter
  1164. to get the menu, because physically the only change the screen
  1165. may be the appearance, or disappearance of the box. PRINT,
  1166. LIBRARY, EDIT and VIEW use the symbol table to perform their
  1167. functions. Therefore if you change to these modes and HAVE NOT
  1168. saved the  current image to the symbol table, you will be given
  1169. the option to either save the current image, or restore the 
  1170. original image. You cannot PRINT, EDIT, INCORPORATE LIBRARY
  1171. ELEMENTS, or VIEW a scaled or re-sized image.
  1172.  
  1173.                          VIEW MODE
  1174.    
  1175.     This mode is a simple VIEW of the image. The box represents
  1176. the section of the image that was visible in grid mode. There two
  1177. additional menu options. 
  1178.  
  1179. MOVE BOX - The box will now respond to the movement of the mouse
  1180. or the arrow keys, Home and End keys, Page Up and  Page Down, and
  1181. the <CNTL>L, <CNTL>R, <CNTL>Page Up and <CNTL>Page Down key
  1182. combinations. Hitting enter or the left mouse button will
  1183. terminate this option, leaving the box wherever it may be. 
  1184.  
  1185. SAVE THIS LOCATION - This option will return you to grid mode
  1186. showing the section of the image that was enclosed in the box.
  1187.  
  1188.                     SELECT SECTION TO PRINT 
  1189.  
  1190.      This mode will allow you to define a section of the image to
  1191. chart. 
  1192.  
  1193. MOVE BOX - The entire box will follow the movement of the mouse.
  1194.  
  1195. MOVE TOP EDGE OF BOX
  1196.  
  1197.  
  1198.  
  1199.                          22        
  1200.  
  1201.  
  1202.  
  1203. MOVE BOTTOM EDGE OF BOX
  1204. MOGE LEFT EDGE OF BOX
  1205. MOVE RIGHT EDGE OF BOX - These options allow you to move any 1
  1206. side  of the box. The selected side will move in accordance to
  1207. the or via the same keystrokes that move the entire box.
  1208.  
  1209. CHART THIS SECTION - The area encompassed by the box will be
  1210. charted.  You will be given the option to chart to a PCX file or
  1211. to the printer.If you choose to create a PCX file of the  chart,
  1212. you will be presented a window showing the files in the current
  1213. print directory.  You can change the  directory, select a file,
  1214. or enter a name for a new file. The image will  then be charted
  1215. to the file. 
  1216.  
  1217.     If you choose to print to the printer you will be presented
  1218. the following information: 
  1219.      
  1220. Page Height (H):
  1221. Page Width (W):
  1222. Title etc (T):
  1223.      
  1224.    Changing the Page height and/or width will change how much of
  1225. the chart can be printed in each page. Using the Title field, you
  1226. can add up to 50 characters for a title, copyright or other
  1227. information. At this point you wil also have to select the Dots
  1228. Per Inch (DPI) that you want the printer to use. The avaialble
  1229. DPI options are presented as checkboxs. Select the density you
  1230. want to use. The higher the DPI, the smaller the squares. Select
  1231. OK when the information is correct. 
  1232.  
  1233.      In addition to any title, on the top of each page will be a 
  1234. page number, for example page 1.1, page 1.2, page 2.1 The first
  1235. number is the "column" the second number is the row. This
  1236. information is presented to help with multi-paged charts.
  1237.  
  1238.      If the chart of the image plus the symbol table take up more
  1239. than 1 page, the symbol table will be printed on a separate page.
  1240. The symbols table will have only the symbols that are  used in
  1241. this section of the image.
  1242.  
  1243.  
  1244. ABOUT THIS SECTION.... - This option will give you the stitch
  1245. size of the current section. 
  1246.  
  1247.                          SCALE IMAGE
  1248.   
  1249.     This mode will show how the image will look if the scaling
  1250. factor is applied. The menu has the following options:
  1251.  
  1252.  
  1253.  
  1254.                          23        
  1255.  
  1256.  
  1257.  
  1258. SAVE THIS SIZE - The current size can be saved either to as an
  1259. CCS file and/or to the symbol table. If you choose the CCS  
  1260. file, you will be presented with a list of CCS files in the
  1261. current directory. Select a file, or enter a new file name. 
  1262. Unless you save to the symbol table, you will be reminded that
  1263. the new size was NOT save when you return to grid mode.
  1264.  
  1265. RESET TO ORIGINAL SIZE - This option will restore the image to
  1266. it's original size.  
  1267.  
  1268. SCALE MENU - This option will present the scale menu. You can 
  1269. change the scale factors. The current scale factors will be shown
  1270. in the edit windows. Any additional scaling will be  performed on
  1271. THIS image, NOT the original image.
  1272.  
  1273.                     CHANGE SIZE OF IMAGE
  1274.  
  1275.     This option displays the new size of the image, as specified
  1276. on the Information menu. 
  1277.  
  1278. SAVE THIS SIZE - The current size can be saved either to as an
  1279. CCS file and/or to the symbol table. If you choose the CCS  
  1280. file, you will be presented with a list of CCS files in the 
  1281. current directory. Select a file, or enter a new file name.
  1282. Unless you save to the symbol table, you will be reminded that
  1283. the new size was NOT save when you return to grid mode.
  1284.  
  1285. RESET TO ORIGINAL SIZE - This option will restore the image to
  1286. it's original size. 
  1287.  
  1288.  
  1289. SIZE MENU - This option will present the size/information menu. 
  1290. You can change the current size. The current size is the size of
  1291. the image being shown. 
  1292.  
  1293.                     INCORPORATE LIBRARY IMAGE
  1294.  
  1295.     This mode will allow you to incorporate library images into
  1296. the current image. The box defines the size of the library 
  1297. element. 
  1298.  
  1299. MOVE BOX - The box will now follow the movement of the mouse,
  1300. and/or respond to the arrow keys.
  1301.  
  1302. CHANGE BOX SIZE - This option allows you to change the size of
  1303. the box. Up/down mouse movements will increase/decrease  the
  1304. height.  Left/right will  increase/decrease the width.  When the
  1305.  
  1306.  
  1307.  
  1308.  
  1309.                          24            
  1310.  
  1311.  
  1312.  
  1313. library element is incorporated it will be scaled up or down in
  1314. accordance to the box size.
  1315.  
  1316. SHOW BOX DIMENSIONS - This option will show you the current size
  1317. of the box. 
  1318.  
  1319. RESET BOX SIZE - This option will reset the box to the original
  1320. element size.
  1321.  
  1322. PUT HERE - This option will incorporate the element into the
  1323. image at the current box location and size.
  1324.  
  1325. GET ANOTHER - This option will present a file listing of the
  1326. current library directory. Another library element can be
  1327. selected and incorporated.
  1328.  
  1329.                          CUT AND PASTE
  1330.  
  1331.     This option lets you select a section of the image and delete
  1332. it, move it or copy it. The menu options are:
  1333.  
  1334. MOVE BOX - The entire box will follow the movement of the mouse.
  1335.  
  1336. MOVE TOP EDGE OF BOX
  1337. MOVE BOTTOM EDGE OF BOX
  1338. MOVE LEFT EDGE OF BOX
  1339. MOVE RIGHT EDGE OF BOX - These options allow you to move any 1
  1340. side  of the box. The selected side will can be controlled either
  1341. by the mouse movement of by the keyboard. 
  1342.  
  1343. DELETE CONTENTS OF BOX - Everything within the confines of the
  1344. box will be deleted.
  1345.  
  1346. MOVE CONTENTS OF BOX
  1347. COPY CONTENTS OF BOX - Everything within the confines of the box
  1348. will be captured. The box will now respond to the movement of the
  1349. mouse. When the box is where you want the selected section to be,
  1350. hit the left mouse button/enter. The original section will be
  1351. moved/copied to the new section. 
  1352.  
  1353.        
  1354.        SYMBOL REDUCTION/DITHERING ALGORITHMS
  1355.  
  1356.      For those of you interested in the mathmatical calculations
  1357. performed for the different dithering algorithms, this section
  1358. is extracted from Steve Rimmers SUPERCHARGED BITMAPPED GRAPHICS
  1359. published by WindCrest Books, an imprint of TAB books a division
  1360. of MacGraw-Hill pages 579-580
  1361.  
  1362.  
  1363.                
  1364.                               25
  1365.  
  1366.  
  1367.  
  1368.  
  1369.     "...The process of dithering images being remapped is called
  1370. error diffusion. Error diffusion is handled using a diffusion
  1371. "filter" of which there are quite a few around. The most commonly
  1372. encountered one is the Floyd-Steinberg filter.  It's drawn like
  1373. this: 
  1374.  
  1375.    X  7
  1376. 3  5  1
  1377.  
  1378.     In this diagram, the X represents the pixel to be remapped.
  1379. The other numbers represent adjacent pixels. The 5, for example,
  1380. is the pixel one line down and immediately below the pixel being
  1381. remapped. In looking at error diffusion filter diagrams, any
  1382. pixels that extend beyond the edges of the picture are ignored.
  1383.  
  1384.     In this filter all the numbers add up to 16. The numbers
  1385. represent the numerators of fractions whose denominators are 16.
  1386. These fractions represent the proportion of the total error to be
  1387. diffused to each of the pixels in the diagram. 
  1388.  
  1389.     To apply this filter to remapping an image, then, you would
  1390. begin with the first pixel.... Having found the nearest match for
  1391. it in the destination palette, you would derive a color error for
  1392. the two RGB values by subtracting the destination red value from
  1393. the source red value, the destination green value from the source
  1394. green value, and the destination blue value from the source blue
  1395. value. We'll call these three numbers rd, gd, and bd
  1396. respectively. 
  1397.  
  1398.     Having derived the color error for the pixel being remapped,
  1399. it can be replaced be the palette entry in question. 
  1400.  
  1401.     Looking at the filter diagram, the pixel to the immediate
  1402. right of the one being remapped should recieve 7/16 of the color
  1403. error. As such, you would find the red value for this pixel and
  1404. add (rd X 7)/16 to it. The same thing can be done for the green
  1405. and blue values. Having done this, you would repeat the process
  1406. for any other pixels affected by this filter. The pixel indicated
  1407. by 3 would be ignored in this case, as it extends beyond the left
  1408. edge the of the picture if you're working with the first pixel in
  1409. a line.
  1410.  
  1411.     Having remapped and diffused one pixel, the filter moves
  1412. right by 1 pixel and the whole circus can start again.....
  1413. Error-diffused dithering can produce distinctly better results if
  1414. you scale a source image up and then dither it. 
  1415.  
  1416.  
  1417.  
  1418.  
  1419.                               26    
  1420.  
  1421.  
  1422.  
  1423.      The results of error-diffused dithering are also affected by
  1424. the filter you use. A filter that communicates with a larger
  1425. number of pixels usually produces more attractive results, as it
  1426. is less likely to make the picture look as if it has a pattern
  1427. built into it. The Stucki filter, for example, usually does much
  1428. better work than the Floyd-Steinburg filer. It looks like this:
  1429.  
  1430.       X  8  4
  1431. 2  4  8  4  2
  1432. 1  2  4  2  1
  1433.  
  1434.     The Stucki filter works with fractions of the color error in
  1435. which the denominator is 42, the sum of alll  the numbers in the
  1436. filter diagram. It's pretty slow compared to the Floyd-Stienburg
  1437. filer. 
  1438.  
  1439.     The Burkes filers is somewhere in between the two preceding
  1440. filter.  It looks like this:
  1441.  
  1442.        X  8  4
  1443.  2  4  8  4  2
  1444.  
  1445. ......."
  1446.  
  1447.  
  1448.                     A FEW WORDS ABOUT SPEED
  1449.  
  1450.     The production of the chart is NOT fast. On my machine (an AT
  1451. compatible) a 640x480 image charted to a PCX file takes 30
  1452. minutes. Why does it take sooooo long?  To create the chart,
  1453. reach individual symbol is converted to an 10x10 dotted symbol.
  1454. Thus ! becomes
  1455.                .
  1456.           .    .
  1457.          ...   .
  1458.         .....  .
  1459.         .....  .
  1460.         .....  .
  1461.          ...   .
  1462.                .
  1463.           .    .
  1464.                .
  1465.  
  1466. Therefore each image row is printed as a chart by making 10 rows
  1467. (and a line).  I'll gladly take any suggestions for speeding up
  1468. the printing and/or creating of the PCX image of the chart.
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.                               27            
  1475.  
  1476.        
  1477.             CONFIGURING/SELECTING A PRINTER
  1478.  
  1479.      To select a printer, run SETPRINT.EXE. This program will
  1480. create a printer configuration file for PCX2CCS.
  1481.  
  1482.      The program MUST be run from the same directory as PCX2CCS,
  1483. since it uses the symbol file for the printer test & the file
  1484. that is generated is "assumed" to be in the same directory as
  1485. PCX2CCS when you run it.
  1486.  
  1487.      To run the program, type SETPRINT, at the DOS prompt. You
  1488. will be shown an alphabetic list of MANUFACTURERS. You can
  1489. scroll the list using the scroll bar. Location and select the
  1490. manufacture of the printer, or the emulator you plan to use.
  1491.  
  1492.      The next display is of the different models made by this
  1493.  
  1494.  
  1495.                               28    
  1496.  
  1497.  
  1498.  
  1499.  
  1500. manufacturer. The (E) or (HP) indicates the codes that are used
  1501. to run the printer. If your printer has a choice between Epson
  1502. and IBM, select (E) for the Epson code set  and set the printer
  1503. for Epson. Mismatching the code set with the emulation will
  1504. result in a printer that does not respond to the print codes.
  1505.  
  1506.      You will be given the chance to run a "quick" test of the
  1507. printer.  If you say "yes", a number different test will be run,
  1508. one for each different dots per inch. 
  1509.  
  1510.     If the test fails, rerun the program: setprint d x . The D
  1511. will generate a printer.tst file. The X will use the current
  1512. pcxccspt.cfg. Without the X you'll have to re-select the printer.
  1513. Without the D you'll re-run the printer test. printer.tst
  1514. contains the commands that were sent to the printer and the of
  1515. data to be printed. Only 1 density will be used. Send this file
  1516. to Chris O'Donnell.  This should help me fix what ever problems
  1517. you are having running your printer. 
  1518.  
  1519.     Even if you don't run the test, the configuration file will
  1520. be created.  If you don't plan to change printers, you can delete
  1521. the following files:
  1522.  
  1523.      setprint.exe
  1524.      prtcode.asc
  1525.      prtmodel.asc
  1526.  
  1527. DO NOT DELETE pcxccspt.cfg. If you do, you will have to re-run
  1528. SETPRINT.  If you DO delete these files, and find that you need
  1529. to re-create the configuration, contact Chris O'Donnell,
  1530. specifying the make and model of the your printer, and I'll
  1531. generate you a new configuration file.  OR send $5.00 (to cover
  1532. postage) and I'll mail you a disk with SETPRINT and all the
  1533. files.
  1534.  
  1535.  
  1536.                                                                                                                                         
  1537.                          HOW & WHY TO REGISTER
  1538.  
  1539.     Why should you register? Well, if you're NOT using this
  1540. program then you shouldn't. If you are using the program then the
  1541. honest thing to do is register. Of course I have no way of
  1542. knowing whose not registered yet using the program, so for
  1543. registered users I offer the following:
  1544.      
  1545.      1) a copy of the program without the obnoxious reminder to
  1546. register, a printed manual, a library of abc's and 123's, a
  1547. master.DMC of all 360 DMC colors, and the RGB2DMC program.
  1548.      
  1549.  
  1550.  
  1551.                          29
  1552.  
  1553.  
  1554.  
  1555.      2) Notification of minor upgrades, which can be download from various
  1556.        sites. OR I can mail them via USPS for $1 (within US $2 outside US).
  1557.      
  1558.      3) Major upgrades for $5.00 (Shipping and handling)
  1559.      
  1560.      4) Information on joining Delphi and getting 5 free hours.
  1561.      
  1562.     There are 3 ways to register PCX2CCS:
  1563.  
  1564.      1) If you are a member of CompuServe, GO SWREG and follow
  1565.         the directions. The $40.00 will be charged to your credit card.
  1566.  
  1567.      2) Printoff REG.TXT and mail it with $40.00 to:
  1568.            Chris O'Donnell
  1569.            PO Box 113
  1570.            Middlebury Ct. 06762
  1571.            USA
  1572.      
  1573.     I will accept Cash, personal check, money order or bank
  1574. checks. If you are nervous about mailing cash, you can obtain a
  1575. Certificate of Mailing (USPS form 3817) from your Post Office.
  1576. This form is evidence that you mailed "something" to my address.
  1577.  
  1578.       3) You can order with MC, Cisa, Amex or Discover from Public
  1579. (software) Library by calling 1-800-242-PSL or 713-524-6394 or FAX 
  1580. 713-524-6398 or by e-mail 71355.740@compuserve.com. You can also mail 
  1581. credit card orders to PsL PO Box 35705, Houston Tx 77235-5705.
  1582. Psl number product number 11619.
  1583.  
  1584.     THE ABOVE NUMBERS ARE FOR ORDERS ONLY
  1585.  
  1586.    Any questions regarding the startus of the shipment of the order, 
  1587. refunds, registration options, produect details, technical support, 
  1588. volume discounts, dealer pricing, site licenses etc must be directed 
  1589. to Chris O'Donnell PO Box 113 Middlebury Ct 06762 203-758-1451
  1590.         
  1591.     In general, I will contact you by e-mail (if you included
  1592. your e-mail address) as soon as I receive your registration
  1593. informing you that I receive your registration and when
  1594. (approximately) will be getting your package into the mail.
  1595.  
  1596.     If you don't hear from me within 14 days of mailing your
  1597. registration, PLEASE CONTACT ME! I usually get the registered
  1598. package out within 3-5 days of recieving the registration.  I do
  1599. NOT wait for a check to clear. Depending on the circumstances,
  1600. you will get a replacement registration package for little or no
  1601. charge. You will need to fill out USPS form 4314-C (US Postal
  1602. Customer Service Card) so we can get the Post Office offically
  1603. involved. Then: 
  1604.  
  1605.     If my package failed to reach you, I will put another in the
  1606. mail ASAP. (return receipt requested if you desire).
  1607.  
  1608.                                30 
  1609.  
  1610.  
  1611.  
  1612.     If you sent your registration by return reciept or recorded
  1613. delivery, send me a copy of the document with form 4314C and I'll
  1614. send you a registered user package. 
  1615.  
  1616.     If you used form 3817, send me a copy of the form, form 4314C
  1617. and $5.00 (for S&H)  and I'll send you a registered user package.
  1618.  
  1619.     If all you did was put a check in the mail, send form 4314C
  1620. and $5.00 (S&H) and I'll send you a registered user package.
  1621.                                                                                                                         
  1622.                     INTERNATIONAL REGISTRATIONS
  1623.  
  1624.     If you live outside the United States and want to register,
  1625. you have the same options, BUT, I will also accept:
  1626.      
  1627.      1) foriegn currancy ONLY IF THE EXCHANGE RATE IS LISTED IN
  1628. BUISNESS WEEKMAGAZINE. (& add 10% for my hassle at the bank).
  1629.      
  1630.      2) American Express Money Orders, payable in US dollars.
  1631.      
  1632.      3) American Express travelers cheques   
  1633.  
  1634.      4) International Postal Money Orders in US dollars
  1635.  
  1636.      5) A Check drawn on a US bank, written in US dollars.
  1637.      
  1638.  
  1639.     I will send to you a registered user package identifing the
  1640. contents as: Diskette, Book and Intellectual Property License. In
  1641. general, only the book and diskette will be taxable.  I will send
  1642. it Airmail.
  1643.  
  1644.           REPORTING PROBLEMS/MAKING SUGGESTIONS
  1645.  
  1646.     If you find a "bug", something that doesn't work quite right
  1647. or hangs your system. Please report it to me. If I can duplicate
  1648. the error, or in any way verify the problem, you will recieve a
  1649. free upgrade, regardless of registration status. (Typos in the
  1650. manual don't count)  
  1651.  
  1652.     If you have a suggestion for future versions (except
  1653. backstitch, I've already thought of that), please let me know. If
  1654. I incorporate your suggestion, you will receive a free upgrade,
  1655. non-registered if you're not registered, registered if you are.
  1656.        
  1657.       
  1658.                             31 
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.